home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_2 / frequest / frequest.dok < prev    next >
Text File  |  1978-01-10  |  14KB  |  370 lines
  1.  
  2.  
  3.  
  4.  
  5.                       Dokumentation zu FRequest Version 1.55
  6.  
  7.  
  8.                              geschrieben 1993
  9.  
  10.  
  11.                          ® 1992/93 H.P.G  FREEWARE
  12.  
  13.  
  14. Index:
  15.  
  16.     Überblick
  17.     Änderungen
  18.     Geschichte
  19.     Rechtliches
  20.     Leistungsmerkmale
  21.     Start Parameter
  22.     Installation
  23.     Beispiele
  24.     Technisches
  25.     Adresse
  26.     Liste der Dateien
  27.  
  28. Überblick:
  29.  
  30.  
  31.         FRequest  läuft  nur  unter  OS  2.xx  Versionen größer als  36.
  32.  
  33.         FR ist ein Tool, mit dem man eine Datei oder ein Verzeichnis mit
  34.         dem neuen OS 2.xx ASLFileRequester auswählen kann, und dann eine
  35.         CLi-Kommandozeile mit der Selektion ausführen kann.
  36.  
  37.         FRequest benutzt viele OS 2.xx Features,  daher  ist  es  leider
  38.         unter 1.3 und 1.2 nicht lauffähig.
  39.  
  40.         Der Requester kann in vielen Wegen vom Benutzer definiert werden.
  41.         Alle Texte, die Auswahl, das PatternGadget und viel mehr kann vom
  42.         Benutzer modifiziert werden.
  43.         Wird eine dieser Optionen nicht genutzt, benutzt FR seine vorein-
  44.         gestellten Werte.
  45.  
  46.         FR macht es möglich, eine angegebene  Kommandozeile  zu starten,
  47.         genauso wie man sie im Cli-Fenster eingeben würde. Wird  in  der
  48.         Kommandozeile dann ein '[]'  eingegeben,  wird  '[]'  durch  die
  49.         Auswahl ersetzt.
  50.         Falls keine Selektion erfolgte, passiert nichts.
  51.  
  52.         FR kann auch benutzt werden,  um  Programme  ohne  PARAMETER  zu
  53.         starten.
  54.  
  55.  
  56.  
  57.  
  58. Änderungen:
  59.  
  60.              von Version 1.5 zu 1.55:
  61.  
  62.                     Die deutsche Version ist jetzt komplett in deutsch gefaßt.
  63.                     Also auch die Kommandozeilenparameter.
  64.  
  65.                     Ich habe drei neue Kommandozeilenparameter hinzugefügt:
  66.  
  67.                     Hoehe=H/K/N   gibt die Höhe des Filerequesters an.
  68.  
  69.                     MULTI=U/S     ermöglicht mehrere Dateien auf einmal auszu-
  70.                                   wählen.
  71.  
  72.                     Speichern=S/S startet den Filerequester mit anderen Farben
  73.                                   und schaltet die Doppelklickauswahl ab.
  74.  
  75.                     Außerdem habe ich einige Enforcer Hits entfernt. Erst jetzt,
  76.                     weil ich einen neuen A4000 bekommen habe und eine Version von
  77.                     Enforcer, die auch damit läuft.
  78.  
  79. Geschichte:
  80.  
  81.     Version 1.5     Erste allgemeine Veröffentlichung.
  82.  
  83.     Version 1.51    Einige Enforcer Hits entfernt.
  84.  
  85.     Version 1.52    Neuer Speichern Parameter eingefügt. Einige Enforcer Hits
  86.                     entfernt.
  87.  
  88.     Version 1.53    Neuer MULTI Parameter eingefügt. Außerdem die Möglichkeit
  89.                     die Höhe des Filerequesters anzugeben.
  90.  
  91.     Version 1.55    Einige Enforcer Hits und Fehler entfernt..
  92.                     Zweite allgemeine Veröffentlichung.
  93.  
  94.  
  95. Rechtliches:
  96.  
  97.  
  98.         Ich habe mich entschlossen dieses Programm und alle  beigefügten
  99.         Dateien und Scripts, sowie aller  Anleitungen  als  FREEWARE  zu
  100.         deklarieren.
  101.  
  102.         D.h.:
  103.  
  104.             Jeder kann FRequest benutzen.
  105.             Jeder darf FRequest weitergeben, wenn:
  106.  
  107.                 1. alle unten aufgeführten Programme mit weitergegeben
  108.                    werden,
  109.  
  110.                 2. keinerlei Veränderungen unten aufgeführten Programmen
  111.                    vorgenommen wurden,
  112.  
  113.                 3. bei   Nachkompilierungen  der  Quell-Codes  muß   ein
  114.                    Hinweis auf den Orginal-Programmierer vorhanden sein,
  115.                    bei Herausgabe dieser, muß eine Kopie an mich gesandt
  116.                    werden.
  117.  
  118.                 4. FRequest darf nicht verkauft werden.
  119.  
  120.                        Außnahme: Es darf eine geringe  Kopiergebühr  er-
  121.                                  hoben werden, die aber 5  DM  bzw.  den
  122.                                  entsprechenden  Gegenwert  in   anderen
  123.                                  Währungen nicht übersteigt.
  124.  
  125.                 5.  FRequest  darf  nur  als  Teil  eines  kommerziellen
  126.                    Produktes herrausgegeben werden,  mit  ausdrücklicher
  127.                    schriftlicher Genehmigung des Autors
  128.                    (Adresse siehe unten).
  129.  
  130.                 Zuwiderhandlungen  der  oben  Aufgeführten   Konditionen
  131.                 werden zivilrechtlich verfolgt.
  132.  
  133.  
  134.         Ferner wird für die Funktion  des  Programmes  ,sowie  möglicher
  135.         Folgen der Benutzung des Programmes sowie  der  u.  a.  Dateien,
  136.         keinerlei Gewährleistung übernommen.
  137.  
  138.         !!! Alle Risiken trägt der Benutzer allein !!!
  139.  
  140.  
  141.  
  142. Leistungsmerkmale:
  143.  
  144.             Man kann das Verzeichnis angeben, daß FR beim Öffnen anzeigt.
  145.  
  146.             Man kann die Datei angeben, die beim Öffnen im  Datei-Gadget
  147.             von FR steht. Wenn man sie nicht angibt,  bleibt  das  Datei
  148.             Gadget leer.
  149.  
  150.             Man kann Pattern (AmigaDOS Standart) angeben, die im Pattern
  151.             Gadget erscheinen angeben. Wenn man sie nicht  angibt,  wird
  152.             '#?' benutzt.
  153.  
  154.             Man kann den GadgetText des positiven und negativen  Gadgets
  155.             angeben. Die Voreingestellten Werte sind: 'OKAY' und 'CANCEL'.
  156.  
  157.             Man kann die Höhe des FileRequesters angeben.
  158.  
  159.             Man kann FRequest mit der MULTI Option starten. Dies ermöglicht
  160.             die Auswahl mehrerer Dateien zur gleichen Zeit, indem man die
  161.             Shift-Taste gedrückt hält und die Dateien mit der linken Maus-
  162.             taste anklickt. Die Auswahl wird dann mit Doppelklick auf den
  163.             letzten Dateinamen beendet.
  164.  
  165.             Man kann die Speichern Option benutzen. Dies öffnet den File-
  166.             requester mit anderen Farben. Die Doppelklickauswahl ist dabei
  167.             aus Sicherheitsgründen abgeschaltet.
  168.  
  169.  
  170.             Man kann einen Titel  für  das  Fenster  des  FileRequesters
  171.             angeben. Der Voreingestellte Wert ist:
  172.             'Bitte Datei auswählen'.
  173.  
  174.             Man kann eine Kommandozeile angeben, bei der  '[]'  mit  der
  175.             Selektion ersetzt werde. Werden keiene '[]' angegeben,  wird
  176.             die Auswahl einfach an das Ende der Kommandozeile angehängt.
  177.             Wird keine Kommandozeile angegeben, wird die Auswahl einfach
  178.             zum Cli-Fenster geschickt.
  179.  
  180.             Man kann FR  auch  zum  Start  von  CLI_Kommandos  benutzen.
  181.  
  182.             Wenn man die QUIET-Option benutzt,  wird  keine  Information
  183.             über die Auswahl zum Fenster geschickt. Dies  ist  besonders
  184.             für BatchScripts nützlich.
  185.  
  186.  
  187.  
  188.  
  189.  
  190. Start Parameter:
  191.  
  192.             FR hat die folgende CLI SYNTAX:
  193.  
  194.     Syntax:  Frequest [Titel=T/K][Ok=O/K][Abbruch=A/K][Verz=V/K][Datei=D/K]
  195.                       [Muster=M/K][Hoehe=H/K/N][Speichern=S/S][MULTI=U/S]
  196.                       [QUIET=Q/S][EXE/S][COM/K]
  197.  
  198.     Erklärung:
  199.  
  200.  
  201.     TITEL:   Zeichenkette   wird TITEL  gefolgt  von  einer  Zeichenkette
  202.                             angegeben, wird diese in die Titelzeile  des
  203.                             Requesters kopiert. Der Voreingestellte Wert:
  204.                             'Bitte eine Datei auswählen'.
  205.  
  206.     OK:      Zeichenkette   wird OK gefolgt von einer  Zeichenkette  an-
  207.                             gegeben, wird die Zeichenkette als Text  für
  208.                             das positive Gadget benutzt.  Voreingestellt
  209.                             ist: 'OKAY'.
  210.  
  211.     ABBRUCH: Zeichenkette   wird Abbruch gefolgt von einer Zeichenkette
  212.                             angegeben, wird diese als Text für  das  ne-
  213.                             gative   Gadget   benutzt.   Voreinstellung:
  214.                             'ABBRUCH'.
  215.  
  216.     VERZ:    Zeichenkette   wird VERZ gefolgt von einer Zeichenkette an-
  217.                             gegeben, so wird diese als  Verzeichnis  be-
  218.                             nutzt, daß der Requester beim Start anzeigt.
  219.                             Voreinstellung: das  momentane  Verzeichnis.
  220.  
  221.     DATEI:   Zeichenkette   wird DATEI gefolgt von einer Zeichenkette an-
  222.                             gegeben, wird diese in das Datei-Gadget  ko-
  223.                             piert. Wird DATEI nicht angegeben, bleibt das
  224.                             Datei-Gadget leer.
  225.  
  226.     MUSTER:  Zeichenkette   wird MUSTER gefolgt von einer Zeichenkette an-
  227.                             gegeben, wird diese  in  das  Muster-Gadget
  228.                             des Requesters kopiert. FRequest zeigt  dann
  229.                             nur Dateien an, die dem MUSTER-Muster  ent-
  230.                             sprechen. Voreingestellt ist: '#?'
  231.  
  232.     HOEHE:   Zahl           wird HOEHE gefolgt von einer Zahl angegeben, wird
  233.                             versucht den Filerequester mit der Höhe in Pixels
  234.                             zu öffnen.
  235.  
  236.     SPEICHERN  ----------   Wird dieser Schalter angegeben, öffnet sich der
  237.                             Filerequester mit anderen Farben. Die Doppelklick-
  238.                             auswahl ist abgeschaltet. Diese Option sollte für
  239.                             Speicheroperationen verwendet werden.
  240.  
  241.     MULTI:   ------------   Wird dieser Schalter angegeben, startet der File-
  242.                             requester im Multimode. Man kann jetzt mehrere
  243.                             Dateien auf einmal auswählen, indem man die Shift-
  244.                             Taste gedrückt hält und die Dateien mit der linken
  245.                             Maustaste anklickt. Der FileRequester wird mittels
  246.                             Doppelklick auf die letze Auswahl beendet.
  247.  
  248.  
  249.     QUIET:   ------------   Dies ist ein Schalter.
  250.                             Ohne Angabe von QUIET, zeigt FR die  Komman-
  251.                             dozeile im Cli-Fenster an, bevor er sie aus-
  252.                             führt. Mit QUIET wird dies verhindert.  Dies
  253.                             ist besonders bei Batch Scripts nützlich.
  254.  
  255.     EXE:     ------------   Dies ist ebenfalls ein Schalter. Wird  weder
  256.                             COM  noch  EXE  angegeben,  (  siehe  weiter
  257.                             unten ) dann zeigt FRequest nur die Selektion
  258.                             an, ohne etwas auszuführen. Wird EXE angege-
  259.                             ben, führt FR die Auswahl ohne PARAMETER als
  260.                             CLI-Kommando aus.
  261.  
  262.     COM:     Zeichenkette   wird COM gefolgt von einer Zeichenkette  an-
  263.                             gegeben, wird diese als Kommandozeile benutzt.
  264.                             Alle '[]' in dieser Kommandozeile werden mit
  265.                             der Auswahl ersetzt. Werden keine '[]' ange-
  266.                             geben, wird die Auswahl an die Kommandozeile
  267.                             angehängt.
  268.  
  269.     Anderes: Wird der FileRequester abgebrochen, passiert  nichts,  d.h.
  270.              es erfolgt weder eine Ausgabe noch  wird  irgendetwas  aus-
  271.              geführt. Will man nur die Einstellungen testen,  dann  kann
  272.              man FR einfach  ohne  Angabe  von  EXE  und  COM  aufrufen.
  273.  
  274.              Man kann COM und EXE nicht zugleich angeben. Wird dies  ge-
  275.              macht, gibt FR einen kleinen Hilfstext aus. Dies  geschieht
  276.              ebenfalls, wenn Falsche Angaben gemacht werden.
  277.  
  278.  
  279. Installation:
  280.  
  281.              Einfachst. Nur FRequest ins C: oder irgend ein anderes Ver-
  282.              zeichnis im aktuellen Suchpfad kopieren.
  283.  
  284.  
  285. Beispiele:
  286.  
  287.                 Ich gehe bei diesen Beispielen davon aus, daß die deutsche
  288.                 Version unter dem Namen FRequest im Pfad der Shell vorhanden
  289.                 ist. Bei älteren Versionen von FRequest war die deutsche und
  290.                 die englische Version von den Kommandozeilenparametern her
  291.                 gleich. Also bitte ältere Versionen löschen.
  292.  
  293.                 1. das ist das einfachste Beispiel, wie man FR aufrufen
  294.                    kann
  295.  
  296.     SHELL 1.> FRequest
  297.  
  298.                 -   FR öffnet  einen  Requester  mit  dem  Titel  'Bitte
  299.                     eine  Datei  auswählen'  und  zeigt  das   momentane
  300.                     Verzeichnis an.  Die  GadgetTexte  sind  'OKAY'  für
  301.                     das  positive  und   'CANCEL'   für   das   negative
  302.                     Gadget.  Wird  eine  Auswahl  gemacht,  wird   diese
  303.                     im Cli-Fenster ausgegeben.
  304.  
  305.                 2. Benutzen von FR in einem alias, um  das  FONTS:  Ver-
  306.                    zeichnis zu wechseln:
  307.  
  308.     SHELL 1.> alias FAss FRequest TITEL "Bitte neues Fonts: Verz wählen"
  309.                 OK "ASSIGN" ABBRUCH "STOP" COM "assign fonts:"
  310.  
  311.                 Wird nun FAss aufgerufen,
  312.  
  313.                 SHELL 1.> FAss
  314.  
  315.                 öffnet FR den  Requester  mit  dem  Titel  'Bitte  neues
  316.                 Fonts:  Verz  wählen'  und  zeigt  den  Inhalt  der  mo-
  317.                 mentanen  Verzeichnisses  an.   Die   GadgetTexte   sind
  318.                 nun 'ASSIGN' und  'STOP'.  Wird  eine  Auswahl  gemacht,
  319.                 wird diese mittels der Kommandozeile
  320.  
  321.                     'assign fonts: <Auswahl>'
  322.  
  323.                 als Cli-Kommando ausgeführt.
  324.  
  325.                 3. Nun ein Beispiel, bei dem fast alle  Angaben  benutzt
  326.                    wurden, die bei FR benutzt werden können.
  327.                    Dieses Beispiel kopiert eine oder mehrere Dateien zu
  328.                    RAM:
  329.  
  330.  
  331.     SHELL 1.> Frequest TITEL "Bitte Datein zum Kopieren auswählen" OK "KOPIERE" MULTI
  332.                        MUSTER "#?.(c|h)" COM "copy [] to RAM:"
  333.  
  334.  
  335. Technisches:
  336.  
  337.             FR ist mit dem MANX Aztec C Compiler Version 5.2a  kompilert
  338.             worden. Die Größe von FR ist ziehmlich klein ( im  Gegensatz
  339.             zu manch anderen ähnlichen Programmen).
  340.             Das ist darauf zurückzuführen, daß ich viele  System-Library
  341.             Calls an Stelle von C-Library Calls benutzt habe.
  342.  
  343.  
  344. Adresse:
  345.  
  346.     Grüße etc.:
  347.  
  348.                 Hans-Peter Guenther
  349.                 Gruener Weg 5
  350.                 W-3501 Fuldatal 2
  351.                 B.R.D (Germany)
  352.  
  353.  
  354. Liste der Dateien:
  355.  
  356.    (Fehlt eine der folgenden Dateien, ist diese Veröffentlichung inkomplett)
  357.  
  358.    FRequest            : Das englische Programm
  359.    FRequest.info
  360.    FRequest_D          : Das deutsche Programm
  361.    FRequest_D.info
  362.    FRequest.doc        : Die englische Anleitung
  363.    FRequest.doc.info
  364.    FRequest.dok        : Die deutsche Anleitung
  365.    FRequest.dok.info
  366.  
  367.  
  368.    *******************************************************************************************
  369.  
  370.